NASA-TM-1 00576 19880014801 


rf/iS/t T/?f- /M S7& 


NASA Technical Memorandum 100576 


THE ENVIRONMENT FOR APPLICATION SOFTWARE 
INTEGRATION AND EXECUTION (EASIE) VERSION 1.0 
VOLUME IV 

SYSTEM INSTALLATION AND MAINTENANCE GUIDE 


DONALD P. RANDALL 
KENNIE H. JONES 
LAWRENCE F. ROWELL 



■or to ....... 

JTlOT TO TALL ; i i-hCJi f /,C Or* 


April 1988 


, ... . ; v jr SEARCH CENTER 
CM, VIRGINIA 

(W\SA 

National Aeronautics and 
Space Administration 

Langley Research Center 

Hampton, Virginia 23665-5225 



PREFACE 


The Environment for Application Software Integration and 
Execution, E A S I E „ provides both a methodology and a set of 
software utility programs to ease the task of coordinating 
engineering design and analysis codes. The need for such 
techniques and tools has stemmed from the computer-aided design 
and engineering activities within the Space Systems Division 
(SSD ) at the Langley Research Center. In SSD, the Vehicle 
Analysis Branch (VAB), with emphasis on advanced transportation 
systems, and the Spacecraft Analysis Branch (SAB), with emphasis 
on advanced spacecraft, share a common need to integrate many 
stand-alone engineering analysis programs into coordinated, 
qu i ck -t u rnaround , user-friendly design systems. In particular, 
the most needed capabilities include easy selection of 
application programs, quick review and modification of program 
input/output data, and logging of the actual steps that were 
executed during the study. Although the application programs 
used by VAB and SAB differ, the design methods used by their 
engineers are quite similar, and great efficiencies can be gained 
by providing a computer "environment" that provides the 
capabilities mentioned above. 

EASIE is both a user interface and a set of utility programs 
which support rapid integration and execution of programs about a 
central relational database. In general, the EASIE system 
addresses the needs of four different classes of people who will 
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be involved in the buildup of an engineering design system. 
Certain individuals may serve in more than one of these roles, 
but the following terms will help to clarify several distinct 
activities associated with the EASIE system. 

The first classification represents the en gi neer/desi gner/ 
analyst. This group conducts the design study through the 
execution of modeling and analysis programs and the generation of 
data required to evaluate the design against its objectives. 
EASIE documentation will refer to this group as “EASIE system 
users" or, more often, as "users." In general, these users are 
only interested in executing programs already installed into an 
EASIE design system. 

A second group aided by EASIE will be referred to as 
"application programmers." These programmers /engi neers are 
responsible for the development and improvement of modeling and 
analysis programs used in the engineering design process. They 
are the experts with respect to particular application programs 
and can define the input and output variables. This definition 
must be done before inclusion of a program with others in the 
integrated system. 

The third group can be referred to as "program 
impl ementers , " since their function is to provide an environment 
where all the software tools work together with a minimum of 
effort. These people will use information provided by the 
application programmers and will install or modify the programs 
in an EASIE system by creating appropriate data constructs in the 
database and locating files where needed by the EASIE executive. 



The fourth classification is that of "design team leader" or 
'design manager." This is the individual or group responsible 
for identifying parameters important to the design study and for 
configuration management of the data as it is produced by the 
design team. This design manager must have an overview of the 
total data requirements for the analysis process and must be 
concerned foremost with the integrity of the data. 

With these terms defined, the four volumes of EASIE 
documentation can be associated with the groups most likely to 
use them. Each of the volumes addresses different aspects of the 
support tools, and each is intended to be usable independent of 
the others . 

Volume I, Executive Overview, provides information about the 
functions, concepts, and historical development of EASIE and 
should be read by anyone trying to determine if EASIE would be 
beneficial to his work. 

Volume II, Program Integration Guide, describes the portion 
of the EASIE tools supporting both the integration of application 
programs into a central database and the definition of the data 
dictionary used during data review and modification. This volume 
will be used primarily by the "program implementer" and the 
"design manager" in their responsibilities for the actual 
installation of appropriate programs into a fully integrated 
design system. However, the "application programmer" may also 
use tools described in this volume to assist in the documentation 
of input/output variables for the application program. 



Volume III, Program Execution Guide, describes the portion 
of the EASIE tools supporting the selection and execution of 
application programs, building of menus, and editing of program 
data. This volume will be of foremost importance to the "users" 
who will perform design studies. In addition, the "program 
impl ementers " will find the sections concerning the construction 
of app 1 i ca t i on -dependent procedures helpful. Finally, this 
document will also be used by the "design manager" for reviewing 
data and design activities. 

Volume IV, System Installation and Maintenance Guide, 
describes the procedure of loading the EASIE system onto a 
computer. It also gives some insight into the hardware and 
software dependencies of the EASIE code. This, most likely, will 
be needed by the "program implementer" to familiarize himself 
with the directory structure and location of the various EASIE 
components. Although the design of EASIE is intended to reduce 
the system dependencies, this version nevertheless reflects in 
several ways the current implementation using the Relational 
Information Management (RIM*) database management system and the 
VAX/VMS + operating system. 
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1.0 INTRODUCTION 


The Environment for Application Software Integration and 
Execution (EASIE) tools include a program executive and a 
collection of data management utilities designed to provide a 
consistent environment for the integration and execution of 
application software. The purpose of this document is to supply 
the programmer charged with implementing or maintaining the EASIE 
software with the required information for performing this 
task. This document may also provide additional insight to an 
engineer/designer/analyst wishing more detailed understanding of 
the organization of the EASIE software tools. When additional 
information on the utilization of the EASIE software tools is 
required, the other three volumes of EASIE documentation [1, 2, 
and 3] in this series should be consulted. 

The computing environment for developing the EASIE software 
tools was a DEC VAX 11/785 running VMS 4.4. When this software 
is being installed, it is very helpful to be familiar with 
VAX/VMS utilities and other VAX/VMS features such as the 
hierarchial file structure, file descriptions and extensions, 
user-defined symbols and logicals, and command procedures. The 
EASIE software is written entirely in DEC FORTRAN 77, using 
standard VAX/VMS compile, load, and execute processes including 
the use of the DEC FORTRAN "INCLUDE" files and the creation and 
use of object libraries. 

In addition to functioning as an EASIE software installation 
guide, this document endeavors to address programming issues not 
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addressed in the other EASIE documentation [1, 2, and 3] and is 
organized into several sections relating to different aspects of 
the EASIE software utilities. Section 2 details the hierarchical 
file organization employed to house the EASIE tools. Section 3 
identifies alternatives for setting up an application programming 
environment utilizing the sample problems contained in Volumes II 
and III. Section 4 provides more detail on the modules that 
comprise the individual EASIE software components. Section 5 is 
an explanation of the task of installing EASIE from the supplied 
installation package. Section 6 provides the information for 
instructing the engineer/designer/analyst for making additions to 
the EAS I E system. 

This document can stand alone in its description of the 
EASIE software installation (section 5); however, some prior 
knowledge of the contents of Volumes II and III will be helpful 
throughout the other sections, since terms and concepts from the 
other EASIE volumes are used here with little or no explanation. 
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2.0 EASIE HIERARCHY 


The organization of the EASIE software takes advantage of 
the VAX/VMS hierarchial file structure. Although each 

installment has flexibility in tailoring the placement of both 
the EASIE tools and any application programs to be associated 
with the system, the organization shown in Figure 1 is 
recommended. The examples used to illustrate the integration and 
execution environments described in Volumes II and III are 
presented in this figure and referenced throughout this 
document. In describing the various levels of the EASIE 
hierarchy, familiarity with standard VAX/VMS file specifications 
is assumed. 

The top level of the hierarchy is the AIDE (a former alias 
for EASIE) directory. Beneath this directory are the major 
subdi rectori es that comprise EASIE. The BUILD_DICT subdirectory 
contains the utilities that are used in constructing the data 
dictionary and the input/output templates within an associated 
data dictionary database. The REVIEWER utility for editing 

program input and output resides in the REVIEW subdirectory. The 
EASIE executive software resides in the PROG subdirectory. The 
PROC, HELP, and DB subdirectories are repositories for files 


needed while 

running 

the 

executive. 

The 

PROC subdi rectory 

conta i ns DCL 

command 

files 

referenced 

f rom 

within the EASIE 

executive. 

The text 

files 

within the 

HELP 

subdirectory are 


accessed while exercising the on-line HELP facility available in 

the executive. Finally, the DB subdirectory includes text files 

containing the major executive command menus. This subdirectory 
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contains the iist of master workspaces [ 3 ] accessible in 

this Version 1.0 of EASIE. The major files ,n each of these 

subdirectories are briefly described in Section 4 of this 
document . 

The remaining three subdirectories, EXAMPLE, EXMENU, and 

exsimple are included to illustrate the alternative methods for 

integrating application programs into this hierarchy. The 

purpose and contents of these three subdirectories are discussed 
in Section 3. 


4 



BUILD_DICT.DIR 

® utilities for constructing the 
data dictionary and the input/ 
output templates 



Figure 1. - EASIE Software File Hierarchy 
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3.0 EASIE PROGRAM INTEGRATION 


The techniques for integrating systems of application 
programs into EASIE are detailed in the Program Integration Guide 
[2]. The intent of this section is to present several approaches 
for organizing the application-program-dependent files into a 
structure compatible with EASIE. The subdirectories EXAMPLE, 
EXMENU, and EXSIMPLE, shown in Figure 1, will serve as 
illustrations for various ways to organize files and set up the 
communication link between the user, EASIE, and the application 
program areas. The mechanism for specifying the necessary data 
path is the EASIE workspace [3]. The utilization of the 
workspace as related to the above three illustrative examples is 
discussed in this section. Finally, an automated tool, in the 
form of a VAX/VMS command file, for constructing an EASIE 
subdirectory structure is detailed. 

The EASIE tools key on the VAX/VMS file extensions when 
performing specified operations. These files come in pairs, an 
object file and an associated description file. For example, a 
workspace file, a configuration database file, and an application 
executable file must all be accompanied by a corresponding 
description file. A complete list of the relevant EASIE file 
extensions is contained in APPENDIX A. For the purpose of 
identifying categories of EASIE files, this document employs the 
file extension and the VAX/VMS "wildcard" character asterisk 
("*"). The is used to designate one or more application 
program names, configuration names, or other user-supplied names. 
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The recommended approach for integrating a suite of 

application programs into EASIE is illustrated in the EXAMPLE 
subdirectory shown in Figure 2. An examination of the files in 
this directory and its subordinate subdirectories shows that the 
EASIE data management utilities [2] have been run and that the 

necessary preparations for interfacing with the executive [3] 

have been performed. The required files have been organized into 
four subdirectories: DICTNRY, SOURCE, PROG, and CFG. 

The DICTNRY subdirectory contains the data dictionary 
database (in the form of the three RIM files, DATADB*. DAT , 

where is 1, 2, or 3). 

The source code, object code, command files, and other 
utilities for compiling and linking the application programs 
reside in the subdirectory SOURCE. It should be noted that the 
database interface routines generated by the EASIE MAKDICT 
utility [2] are also stored in the subdirectory SOURCE. The 
EASIE code generator named these routines *IN.F0R for input and 

♦OUT. FOR for output together with the DEC FORTRAN "INCLUDE" files 
♦IN. COMMON and *0UT. COMMON where "*" represents the application 
program name. 

The application program executables *.EXE and the EASIE 
REVIEWER [2] files *IN.REV or *0UT.REV reside in the PROG 
subdirectory. The required description files [3] for the 
applications program *.APPLD and the REVIEWER files *.TPLD also 
exist in the PROG subdirectory. 

The CFG subdirectory contains the "master" configurations 
* . D I R that may be copied to a user's area for execution. Each 
master configuration is described by an *.CFGD description 
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file. The remaining file in the CFG subdirector y is the 
workspace [3] which points to the master configurations and 
application programs. 

The file PROGRAM. PGD in the PROG subdirectory is required by 
the EASIE executive when executing user application programs. 
The file is created by the SYSTEM LIBRARY PROCESSOR in producing 
the PROGRAM LIBRARY [2], The EASIE executive needs this file to 
identify the method and/or steps necessary in exercising an 
application program. 

The final step in preparing an EASIE execution environment 
is to update the master workspace file, MASTER_WS.DAT, which 
resides in the [.AIDE. OB] directory (figure 1). In this 

instance, the entry of EXAMPLE for USER ID is added to the 

MASTER_WS.DAT file, in order to identify EXAMPLE as a legal EASIE 
ID [3] and to locate the corresponding EXAMPLE. WS workspace. 
With the organization and specification of the execution 
environment now complete, an EASIE session using EXAMPLE as the 

USER ID: will initiate EASIE execution from a working area, copy 

a master configuration (from the [.AIDE. EXAMPLE. CFG] 
subdirectory), and begin issuing EASIE commands. 

An alternate method for structuring the integration of a 
suite of application programs into an EASIE execution environment 
is shown in the EXMENU directory listed in figure 3. 

In this organization, only a single subdirectory named CFG is 
required. The EXMENU approach utilizes the EASIE executive 
facilities for procedures and menus. The subdirectory 
[. EXMENU. CFG ] contains the required procedures *.PR0C, procedure 
descriptions *.PR0CD, and the menu files *.PR0C *. It is 
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unnecessary to locate application programs in source or 
executable format and configurations in this area because the 
actual location of these files is specified in the workspace, 
EXMEN U.WS. In essence, the EXMEN 1J ID appears to be used to log 
into a separate design system. The EXMENU ID only provides menus 
and pointers to other programs contained in other ID areas. As 
in the previous paragraph on the ID EXAMPLE, the final step is to 
update the master workspace file, MASTER_WS.DAT, to reflect 
the new execution environment. An EASIE session using EXMENIJ as 

the USER ID: will run EASIE from a working area choosing EXMENU 

as the desired design system. 

A partial implementation of another method for structuring 
the integration of a suite of application programs into an EASIE 
execution environment is described in the EXSIMPLE subdirectory 
shown in Figure 4. The files in this area represent the results 
from exercising a simple integration example of EASIE Volume II 
Program Integration Guide [2]. There are no subdirectories under 


EXSIMPLE , 

implying 

that 

all programs. 

configurations. 

and 

REVIEWER 

files reside in 

this single 

subdi rectory . 

The 

responsibility for 

creating 

the required 

description files 

for 


the programs, configurations, and REVIEWER files is assigned by 
the design manager at each installation. The design manager must 
also create the DATADB*.DAT database files. When these functions 
are completed, the EXSIMLE.OIR files may be copied to another 
work area. In this manner, the engi neer/des i gner /analyst may 
exercise EASIE in a self-contained environment. This alternative 
method for structuring the EASIE execution environment is not 
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suited to multiple user environments or multiple 
configurations. When exercising EASIE in this environment, 
entering a carriage return [CR] in response to the "10" prompt 
produces a proper workspace in the user's own area. (WARNING - 
The EASIE engi neer/desi gner/analyst should be warned that using 
this approach, configuration directories function as both master 
and user configurations because the master and user areas are the 
same . ) 

The preceding paragraphs and figures may appear to depict a 
complex program integration and execution environment. However, 
the integration process is performed only once for each suite of 
application programs. Also, this effort is seen only when the 
EASIE software is installed and the details of the organization 
are transparent to the engi neer/desi gner/analyst . 

In an effort to ease the EASIE software installment, a 
VAX/VMS command file, AIDEINIT.COM, is provided to automate the 
creation of the EASIE setup as depicted in the EXAMPLE 
subdirectory. Invoking the command file AIDEINIT.COM before 
beginning the integration process will facilitate proper file 
placement. The functions of this command file include prompting 
for EASIE ID [3], creating directory and subdirectories as 
prescribed above, generating an empty data dictionary database, 
updating the master workspace file, and producing a workspace 
file to be used with this environment. 

The command file is listed in APPENDIX B. VAX/VMS symbols 
are utilized wherever possible to eliminate the drawback of hard- 
wired file specifications. The designated symbols are identified 
and defined in Section 5 of this document. 
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Figure 3. * Menu-Driven Application Program File Structure 


EXSIMPLE. DIR 

• no subdirectories 

•the implementer is responsible for 
creating the required description files 

• application source code 

• application object code 
© data dictionary/template 

library database 
© schema 

© RIM database files 


Figure 4. - Self-Contained Application Program File Structure 






4.0 EASIE UTILITIES 


This section presents the individual EASIE executive and 
data management utilities from a programmer's viewpoint. The 
component files are identified, and the compile/load sequences 
are specified. When appropriate, terminal-, DBMS-, and VAX/ VMS - 
speci f ic-dependenci es are discussed. 

4.1 EASIE Executive Initialization 

The files comprising the EASIE executive reside in the 
[.AIDE. PROG] directory. The files in this area include the DEC 
FORTRAN source modules *.FOR, the FORTRAN "INCLUDE" files *.INC, 
the compiled object code files *.OBJ, the generated object 
libraries *.OLB, the compile and link command files COMPILE.COM 
and LINK.COM, and the executable task image MASTER.EXE. 

The required FORTRAN source files are listed and briefly 
described in Table 1. The compilation of these modules requires 
no special compiler options. A sample command file for linking 
the EASIE executive is listed in APPENDIX C. Notice that this 
command file employs VAX/VMS symbols in order to eliminate hard- 
wired pathnames. 
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TABLE 1. - EASIE EXECUTIVE FORTRAN MODULES 


NAME 


DESCRIPTION 


AIDEUTIL Collection of utilities for performing 

type conversions and manipulating VAX/VMS 
file specifications. 

BATCH Routines for controlling the executive's 

background processing capabilities. 

DISPLAY Routines for listing executive menus and 

user text files to terminal. 

EDTPL Routines designed to permit user template 

editing. At the present time, these 
routines are incompatible with other EASIE 
data management utilities. 

ERRORSUBS Routines for categorizing executive errors 

and outputting messages to user's log 
and/or termi nal . 

FASTAIDE Routines for initializing executive and 

controlling its operation. 

GET Routines for controlling executive 

functions normally associated with the 
EASIE procedure facility. 

GETMENU Routines for processing user-supplied 

menus associated with user-supplied 
procedu res . 

GLOBS Routines for reading, writing, and 

updating EASIE workspace files. 

INTERACT Routines used for communicating with users 

such as issuing prompts and soliciting 

responses . 

INTERPRET Routines for parsing user input and 

validating user-supplied information. 
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TABLE 1. - (continued) 


NAME 


DESCRIPTION 


MASTER 

PERMENU 

PUTTRM 

RESPPROCS 

RIMSUB 

SLOG 

SYSUTIL 

TEMPSUB 

TERMINAL 


EASIE executive driver program. 

Moduleof routines to control selection of 
executive menus and other functions such 
as listing configurations or applications. 

Program that prompts the user for the 
terminal type. 

Module containing the major executive 
command routines. 


Routines communicating with the user's 
execution environment. These utilities do 
not communicate with resident DBMS. 


Utilities for modifying user's login 
environment via workspace editing. 


Utility routines for 
VAX/VMS during executive 


interacting 

execution. 


wi th 


Routines controlling such executive 
function as "execution" of programs or 
procedures or online "help". 


Routines for directing limited termi nal 
independence capabilities. 
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4.1.1 Executive System Dependence 

The selection and manipulation of EASIE executive files 
depend on the VAX/VMS file specification. The executive is 
interfaced to VAX/VMS through standard VAX/VMS system interface 
routines. In some cases, a VAX/VMS utility is used directly such 

as invoking the LIRSFIND FILE to identify configurations, 

applications, workspaces, and procedures. In other instances, 
LIRSSPAWN is employed to execute a VAX/VMS command string for 
such functions as invoking the ED editor or executing an 
application. 

In an effort to aid in the migration of the EASIE executive 
to another host, the VAX/VMS dependencies have been isolated to 
the extent possible. The vast majority of VAX/ VMS dependencies 
are consolidated in the two modules, A I DEUT I L . FOR and 
SYSUTIL.FOR. There are other VAX/VMS dependencies in some of the 
remaining executive source modules, but these should be 
relatively easy to identify and correct. These dependencies 
usually take the form of creating a VAX/VMS string such as ED to 
invoke the editor or RUN/NODEBIJG to execute a program. There may 
also be brackets from a VAX/VMS file specification or references 
to a VAX/VMS symbol . 

Because the EASIE executive invokes standard VAX/VMS 
utilities, the user should not redefine any of these utilities 
via symbol definitions. 
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4.1.2 Terminal Independence 

The EASIE utilities provide a very limited capability for 
terminal independence. The default terminal is a generic 
alphanumeric terminal. In its present form, terminal 

independence implies "erasing" the screen and text positioning 
for the Tektronix 401x series terminals and only clearing the 
screen for the Tektronix 41xx series terminals. 

The termi na 1 -i ndependent routines reside in TERM I NAL . FOR . 
These routines are unconditionally loaded by the executive but 
are linked as an object library by other EASIE utilities. For 
Tektronix 401x terminals, the proprietary PLOT-10 Terminal 
Control System ( T C S ) library is required. A minimal LaRC- 

developed Tektronix 41xx library is included as part of the 
installation package to support this class of terminal. To add 
another class of terminal, edit TERMINAL. FOR and include the 
device-dependent libraries for the new devices required. 

The principal mechanism for communicating the terminal type 
throughout the software is a file named AIDExx.TRM where 'xx' is 
the VAX/VMS expansion of the ' TT * symbol associated with the 
user's job. This file may be written to the user's working area 
by the program PUTTRM.EXE which is executed from the procedure 
TOA I OE : [ PROC ] A I DE . COM . The executive calls a routine TINIT 
(within TERM I NAL . FOR ) to read an existing terminal file 

(AIDExx.TRM). Integrated programs and the REVIEWER employ this 

technique via the routine PINIT in file TERM I NAL. FOR. An 
installation using the EASIE software may choose to exercise 
PINIT in a similar manner for any of their application programs. 


17 



4.1.3 Use 


The EASIE executive may be invoked by entering 
RUN TOAIDE : [PROGDMASTER.EXE 

The installation process described in section 5 illustrates an 
alternate method of execution whereby a VAX/VMS symbol, AIDEX, is 
used to run the command procedure T0AIDE:[PR0C]AIDE.C0M, which in 
turn executes the above command line and performs the terminal 
selection process. In either case, TOAIDE is a symbol used to 
specify a partial pathname. 

The engineer/designer/analyst user should invoke the EASIE 
executive as described above from a working area that is to 
contain the relevant configurations (stored as subdirectories and 
identified by the *.CFGD description files). During execution, 
EASIE creates several temporary files using a naming convention 
similar to that discussed in the previous section. The temporary 
files are prefixed by * T $ * and identified by the appropriate file 
extension (APPENDIX A). In order to permit multiple users to 
simultaneously execute EASIE from the same working area, the 
VAX/VMS symbol 'TT' corresponding to the user's terminal is 
expanded and added to the file name. For example, the temporary 
log file may have a name such as 1 T $TTA7 . LOG ' . 

The EASIE executive deletes the temporary files upon logout 
except the * . TRM and * . LOG files remain. If the executive 
terminates abnormally, other 1 T$ 1 files may reside in the working 
area. If an abort occurs during the execution of an application 
program, the directory pointer may be positioned inside a 
configuration. In order to remedy this problem, reposition the 
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directory pointer to the working area and delete the temporary 
files. 

4.2 Data Management Utilities 

The purpose of this section is twofold. The fi rst is to 
document the location and function of both the SYSTEM LIBRARY 
PROCESSOR, software used to construct and manipulate the SYSTEM 
LIBRARY (including DATA DICTIONARY, TEMPLATE LIBRARY, and PROGRAM 
DICTIONARY), and the REVIEWER, software used to review/modify 
data [2.1. The second is to explain modifications necessary for 
use of these utilities with a DBMS other than RIM [4]. 

4.2.1 SYSTEM LIBRARY PROCESSOR 

The files comprising the SYSTEM LIBRARY PROCESSOR (executed 
via the VAX/VMS symbol 'RUNDICT') reside in the [.AIDE. BUILD 
DICT] directory. Linking the processor is accomplished through 
execution of the command procedure MAKDICT.COM producing an 
executable task image MAKDICT.EXE. Examination of this command 
procedure reveals that the object files (and their associated 
source files) are required by the processor. The processor 
currently stores the SYSTEM LIBRARY in a RIM database and can 
interact with it both to produce a database containing a schema 
only and to construct a FORTRAN code to ret r i e ve/rep 1 ace data 
from/in the database. 

An input file to be read by interactive RIM is created by 
the module MAKSCHEMA.FOR called by selecting the BS (Build 
Schema) command. The input file created contains commands to 
interactive RIM for creating the relations defined in the DATA 
DICTIONARY using the default database name, DATADB. The database 
name may be changed by editing this file before execution. 
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The FORTRAN code produced by the SYSTEM LIBRARY PROCESSOR 
(the BF command) is written by the modules FORMAT. FOR and 
FORMR IM . FOR . The module FORMAT. FOR does the bulk of the work of 
transferring data to/from variables from/to a single integer 
array. The module FORMRIM.FOR writes the calls to the RIM 
FORTRAN interface library. Resident within the processor is a 
user-supplied parameter for the number of characters per machine 
word to be contained in the storage array (input as the response 
to the processor's first prompt). This parameter is required 
because DBMS's (RIM, for example) may not be totally machine 
independent. On a VAX, RIM character attributes are packed into 
the storage array using four characters per word. This parameter 
controls how character attributes will be packed by FORMAT. FOR. 

The [ . A I DE . BU I LD_D ICT ] directory contains two files which 
create the SYSTEM LIBRARY Schema. The file BUILD.DAT contains 
commands to interactive RIM for the schema construction. The 
file BUILDDICT.COM is a command procedure to copy BUILD.DAT into 
the default directory of the user, execute interactive RIM, and 
input the file BUILD.DAT thus creating a schema-only database in 
the default directory. 

Program GETDESC . OB J (source file GETDESC . FOR ) , when linked 
with the RIM Library, produces an executable that reads the Data 
Dictionary and generates an output file containing all 
parameters/attri butes for each relation, including their names, 
descriptions, and units. This is useful as a quick overview of 
the database schema contents (table 2). 
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All FORTRAN modules described above are written in ANSI 
standard FORTRAN V with the exception of variable names exceeding 
the 6 character ANSI standard. The processor will successfully 
compile and link on both the VAX/VMS and PRIME/PRIMOS systems 
with only one required modification. The FORTRAN input and 

output unit numbers are assigned through a data statement in the 
main program ( I N = 5 for VAX and I N = 1 for PRIME; I0UT = 6 for VAX and 
1 0 U T = 1 for PRIME). A modification to these values may be 

required for conversion to another machine. Oimensions, though 
large in some cases, are usually assigned as parameter 

statements, and some may be reduced for use on a non-virtual 
machine. (However, this is not recommended.) 
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TABLE 2. - SAMPLE OUTPUT OF PROGRAM GETDESC 


THE PARAMETERS FOR THE RELATION OIMEN ARE 

NAME DESCRIPTION UNIT 

LENGTH BOX LENGTH M 

WIDTH BOX WIDTH M 

HEIGHT BOX HEIGHT M 

VOLUME BOX VOLUME M 

THE PARAMETERS FOR THE RELATION MODEL ARE 

NAME DESCRIPTION UNIT 

NAME MODEL NAME 

ROTATION MODEL X,Y,Z ROTATIONS RESPECTIVELY DEGREES 

THE ATTRIBUTES FOR THE RELATION NODES ARE 

NAME DESCRIPTION UNIT 

X X COORDINATE M 

Y Y COORDINATE M 

7 . 1 COORDINATE M 

THE ATTRBUTES FOR THE RELATION FACES ARE 

NAME DESCRIPTION UNIT 

FACE FACE CONNECTIVITY (NODE 1 TO 2 TO 3 TO 4 (OR TO 1 IF 4=0) TO 1) 
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4.2.2 REVIEWER 


The files comprising the REVIEWER reside in the 
[. A [ DE . RE V IE W] directory. Upon execution of the command 
procedure RIMLOU.COM. the source file R4.F0R will be compiled and 
linked with the RIM library to produce the executable task image 
R4.EXE. 

The value for number of characters per word resident in the 
SYSTEM LIBRARY PROCESSOR is passed to the REVIEWER through the 
REVIEWER input file. 

Only one VAX dependency is found in the REVIEWER. In the 
subroutine RUREV, a call to the VAX system function 

LIB$GET FORE IGN returns the name of the REVIEWER input file to 

read and optionally the word "PRINT" (if the output is to be 
written to a file). For conversion to another machine, this 
mechanism must be emulated. Otherwise, the above statements 
concerning ANSI FORTRAN V standards, input /output units, and 
dimensions apply. 

4.2.3 Conversion to Another DBMS 

The previous discussion of the SYSTEM LIBRARY PROCESSOR and 
the REVIEWER indicates a dependence on the RIM [4] DBMS. Another 
version of the EASIE data management tools which employs 
Structural Dynamics Research Corporation's PEARL [5] DBMS has 
been developed. The intent of this section is to contrast the 
RIM and PEARL implementations in the event that another DBMS is 
emp 1 oyed . 

Several of the modules located in the [.AIDE .BUILD_DICT] are 
particularly noteworthy for conversion to another DBMS. The 
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processor currently stores the SYSTEM LIBRARY in a RIM database 
but may interact with either the RIM or PEARL DBMS. 

The SYSTEM LIBRARY PROCESSOR BS command was previously 
described as a mechanism for building a RIM input file for 
creating relations within the DATA DICTIONARY. Alternatively, an 
option of the BS command will call the module MAKPRLSCH . FOR to 
create a FORTRAN program that, when linked with SDRC's PEARL 
library and executed, will create the schema for the PEARL 
database, DATADB. These methods represent two different means of 
creating the initial database schema. One method is through 
commands to an interactive database manager, and the second 
method is by interfacing with a FORTRAN library. One or both of 
these modules should serve as a model to create the schema for 
other relational DBMS's. 

FORTRAN code produced by the SYSTEM LIBRARY PROCESSOR (the 
BF command) (written by the modules FORMAT. FOR and FORMR I M . FOR ) 
may be somewhat database independent provided the DBMS of choice 
retrieves/stores data in a manner analogous to RIM and PEARL. 

The user-supplied parameter indicating the number of 
characters per machine word used in controlling the packing of 
character attributes requires further explanation. On a VAX, RIM 
character attributes are packed into the storage array using 4 
characters per word, while on the CDC Cyber/NOS computer, RIM 
character attributes are packed using 10 characters per word. 
Using the PEARL DBMS on VAX, character attributes are packed 
using 2 characters per word. This parameter may be useful in 
conversion to another DBMS. 
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If the DBMS of choice packs relation rows into a temporary 
storage array using the same method as RIM and PEARL, it is 
possible that only FORMRIM.FOR need be modified. If not, 

modifications to FORMAT. FOR may be required. 

The interface with PEARL was accomplished with no 
modifications to either FORMAT. FOR or FORMRIM.FOR because PEARL 
is similar to RIM. Instead, an interface libra ry was created 
(with few subroutines) to convert RIM subroutine calls to PEARL 
calls. Code produced by the processor is then identical for RIM 
or PEARL with the exception of number of characters per word. A 
program may then be linked with both the RIM-to-PEARL interface 
library and the PEARL library in lieu of the RIM library. This 

approach is simple and results in no noticeable loss in 

performance. 

The SYSTEM LIBRARY is stored in a RIM database. If RIM is 

not acceptable, conversion to another DBMS should be possible. 

All RIM subroutine calls have been isolated in the module RDDICT 
and can be replaced by calls to another DBMS. Also, the files 
BUILDDICT.COM and BUILD.DAT (residing in the [.AIDE. BUILD DICTJ 
directory) used in creating the schema-only database must be 
edited accordingly to create the SYSTEM LIBRARY schema using 
another DBMS. 

Conversion of the REVIEWER to another DBMS may be 
accomplished through modification of the following subroutines: 
DBOPEN 
DBCLOSE 
RDPARA 
RDATT 
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WHRVAl 


DB2REV 

WRTPARA 

WRTATTR 

REV2DB 

The approach used for the PEARL interface requires no changes to 
the REVIEWER. (Instead, the REVIEWER is linked with the RIM-to- 
PEARL library and the PEARL library.) An analogous approach may 
be possible with other DBMS's. 
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5.0 INSTALLATION 


The EASIE installation tape was written on a VAX 11/785 
running VMS 4.5. The magnetic tape is 9-track, 1600 8PI and 
written with the VAX/VMS BACKUP utility. The BACKUP utility was 
utilized because the so-called "SAVESET" preserves the 
hierarchical directory structure described in Section 2. 
APPENDIX D contains the INSTALLATION TAPE BACKUP listing. 

Using BACKUP to read the installation tape, the EASIE 
hierarchy is created starting from the current working area where 
the directory pointer is positioned. The highest level directory 
is EASIETAPE and is referenced in this section using the relative 
file specification [.EASIETAPE]. 

The command file BUILD.COM (APPENDIX E) located in the 
.EASIETAPE directory may be used to generate the required EASIE 
executables and sample environments (section 2) positioned 
properly within the hierarchy. Before invoking this command 
file, editing the symbol definitions in BUILD.COM to conform to 
local disk logical name assignments is required. As alluded to 
earlier in this document, these symbols are defined to facilitate 
moving EASIE from one area or system to another. 

The symbol TOAIDE defines a file specification from the 
logical disk name to the AIDE subdirectory. The symbol s LOADR IM 
and L0ADP10 identify the locations of the proprietary RIM and 
PLOT-10 TCS libraries, respectively, used by the EASIE 
utilities. (The PLOT-10 library used by the executive and the 
REVIEWER is not mandatory for Tektronix 41xx series or 
alphanumeric terminals. The RIM FORTRAN interface library is 
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required for all EASIE data management utilities.) The USERLIB 
symbol identifies the location of the two user libraries 
delivered as part of the installation package. By default the 
libraries are located in the [.EASIETAPE] subdirectory. 

The other symbols (RUNRIM, RUNDICT, REVIEW, and AIDEX) 
defined in BUILD.COM are not used by the command file. The 
utility of these symbols is addressed in the next section. Of 
these four symbols, only RUNRIM, which is used to execute 
interactive RIM, must be redefined by the installer. 

Once the symbols are defined, BUILD.COM runs other command 
files (from the appropriate areas) which link the necessary 
object modules to build the EASIE components. The implication 
here is that these command files do not perform recompilation but 
use the object files from the installation tape. If 
recompilation is deemed necessary, the individual command files 
may be scanned to identify source modules. No special compiler 
options are required. 

After the symbols are defined and any necessary 
recompilations are performed, BUILD.COM may run from the 
[.EASIETAPE] subdirectory by issuing the VAX/VMS command: 

OBUILD.COM 

A listing of this command file is provided in APPENDIX E. 
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6.0 MAINTENANCE 


Assuming the instructions from section 5 were performed 
successfully, EASIE should now be usable by potential users 
wishing to exercise the sample program environment detailed in 
Volume II. 

In an effort to aid the engineer/designer/analyst exercising 
the EASIE utilities, the symbol s RUNRIM, RUNDICT, REVIEW, and 
AIDEX, defined by [. EAS I ETAPE ]BU I LD . COM , (APPENDIX E), may be 
used. The symbols RUNRIM, RUNDICT, REVIEW, and AIDEX are used to 
execute interactive RIM, the EASIE data dictionary utilities, the 
REVIEWER, and the executive, respectively. The symbols RUNDICT, 
REVIEW, and AIDEX use another symbol, TOAIDE , in their 
definition. TOAIDE designates the location of the EASIE 
hierarchy based on the established logical disk configuration and 
should be set when this software is installed. The RUNRIM symbol 
is also system dependent and must be defined when the software is 
i n s t a 1 led. 

A recommended approach for defining these symbols is to 
imbed their definitions within the system and/or user's "login" 
file. In this manner, the symbols are always available to the 
EASIE user. Note that entering AIDEX to invoke the executive 
actually runs another command file TOA I DE : [PROG ]A IDE .COM . This 
command file is included with the installation package. 

The beginning EASIE user executes EASIE from a working area 
and not from the EASIE area. The directory [.EASIETAPE] and the 
subordinate subdirectories should be protected from over writing 
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by the design manager/ system administrator responsible for 
maintaining the EASIE tools. More specifically, the 

engineer/designer/analyst should have rights to copy master 
configurations and to execute EASIE or applications programs but 
should not be permitted write access to this area. This area 
requires modifications only when correcting an error in an EASIE 
utility, adding an update, or changing a particular application 
environment. The latter case might include such activities as 

adding a new application program, editing an old application 
program, adding a master configuration, or editing the procedures 
and menus used to tailor an existing environment. 

By contrast, the engi neer/desi gner/analyst should: 
o Ensure that the aforementioned symbols are defined, 
o Attach to the area where the user configurations 
procedures, and workspaces reside, 
o Initiate execution of the desired EASIE utility, 
o Issue commands as discussed in volumes II and III. 

One final caution concerns the EASIE executive convention of 
"spawning" VMS processes to execute certain commands. Depending 
on system dependent parameters, the error message 
"EXPRCLM, exceeded subprocess quota" 
may abort the executive. If this error occurs, the VAX system 
administrator should increase the PRCLM parameter. 
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APPENDIX A 


NAME 

APPL 

APPLD 

CFCD 

COM 

DIR 

EXE 

LOG 

PROC 

PROCD 

REV 

SAV 

TPL 

TPLI) 

UTIL 

xxx x_i 

WS 

WSD 


EASIE FILE EXTENSIONS 

DESCRIPTION 


APPLICATION PROGRAM 

APPLICATION DESCRIPTION FILE 

CONFIGURATION DESCRIPTION FILE 

BATCH COMMAND FILE 

CONFIGURATION (Also VAX/VMS 
Subdi rectori es ) 

APPLICATION PROGRAM (Also a 
VAX/VMS Executable Image) 

EASIE LOG FILE 

EASIE PROCEDURE FILE 

PROCEDURE DESCRIPTION FILE 

EASIE REVIEWER (TEMPLATE) FILE 

BATCH OUTPUT FILE 

EASIE TEMPLATE FILE 

TEMPLATE DESCRIPTION FILE 

USER-WRITTEN UTILITY FILE 

"i (th ) " MENU FILE ASSOCIATED 
WITH PROCEDURE xxxx 

EASIE WORKSPACE FILE 

EASIE WORKSPACE DESCRIPTION 
FILE 
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COMMAND FILE FOR AUTOMATING 
APPLICATION PROGRAM ENVIRONMENT SETUP 


SHOME = F $0 I RECTORY ( ) 

$ I NQU I RE ID "ENTER EASIE SYSTEM ID " 
SSTRLEN = F SLENGTH (ID) 


SIF 

(STRLEN 

.LT. 1) 

THEN WRITE 

SYSSOUTPUT 

"ID MUST 

BE 

GT 

CHARACTERS" 







SIF 

(STRLEN 

.LT. 1) THEN GOTO EXIT 





SIF 

(STRLEN 

.GT. 8) 

THEN WRITE 

SYSSOUTPUT 

"ID MUST 

BE 

LE 


CHARACTERS" 

$ IF (STRLEN .GT. 8) THEN GOTO EXIT 
$CREATE/DIR TOA I DE : [ ' I D ' ] 

$CREATE/DIR TOA I DE : [ ’ I D ' . C FG ] 

SCREATE/DIR TOA IDE :[' ID ' .CFG .MASTER ] 

SCR E ATE TOA IDE: [ ' I D ' .CFG ]MASTER . CFGD 
SCREATE/DIR TOA I DE : [ ' I D ' . D I CTNR Y ] 

SCREATE/DIR TOA I DE : [ ' I D ' . SOURCE ] 

SCREATE/DIR TOA I DE : [ ' I D ' . PROG ] 

$TA = F$LOGICAL("TOAIDE") 

$ L E N = F SLENGTH (TA) 

STA = F$EXTRACT(0,LEN-1,TA) 

$TA = TA+ID+" .DICTNRY]" 

SWRITE SYSSOUTPUT TA 
SSET DEFAULT 'TA' 

SCOPY TOAIDE: [BUILD DICT]BU ILD . DAT * 

SRUNRIM 
INP BUILD 
EXIT 

SDELETE BUILD. DAT . * 

SIF (STRLEN ,EQ. 1) THEN B = " 

SIF (STRLEN .EQ. 2) THEN B = " 

SIF (STRLEN .EQ. 3) THEN B = " 

SIF (STRLEN .EQ. 4) THEN B = " 

SIF (STRLEN .EQ. 5) THEN B = " 

SIF (STRLEN .EQ. 6) THEN B = " " 

SIF (STRLEN .EQ. 7) THEN B = " " 

SIF (STRLEN .EQ. 8) THEN B = "" 

SOPEN/APPEND MWS TOA I DE : [DB ]MASTER WS.DAT 
SWRITE MWS ID,B,"T0AIDE:[",ID,".CF1T]",ID,".WS" 
SCLOSE MWS 

SOPEN/WRITE WS TOA I DE : [ ' I D ' . C FG ] ' I D ' . WS 
SWRITE WS "USRIO ",ID 

SWRITE WS "USRLVL 1" 

SWRITE WS "MENUCMD F" 

SWRITE WS "REFCFG" 

SWRITE WS "APPLTPL" 

SWRITE WS "REFTMPL" 

SWRITE WS "APPLTMPLIN" 

SWRITE WS "AP PLTMPLOUT" 

SWRITE WS "REFPCF" 
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SWRITE 

WS 

"CURPROG" 


SWRITE 

WS 

"WKSP 

TS" 

SWRITE 

WS 

"CURMENU 

UTILITY SELECTION (MAIN)" 

$WR I TE 

WS 

"CURMENUIDX 

1" 

SWRITE 

WS 

"INUNIT 

5" 

SWRITE 

WS 

"OUTIUNIT 

6" 

SWRITE 

WS 

" PRINT LEVL 

1" 

SWRITE 

WS 

"HOMEUFD " 


SWRITE 

WS 

"BASEUFD 

TOAIDE: [".ID, ".CFG]" 

SWRITE 

WS 

"PROGUFD 

TOAIDE: [" , ID, ".PROG]" 

SWRITE 

WS 

"MENULIST 

! " 

SWRITE 

WS 

"SEQEXEC 

F" 

SWRITE 

WS 

"SEQNUM 

0" 

SWRITE 

WS 

"PROCSP 

0" 

SWRITE 

WS 

"PROCPC 

0" 

SWRITE 

WS 

"PROCEX 

F" 

SWRITE 

WS 

"EMPTYPROCSTACK 

T" 

SWRITE 

WS 

"AUTODEFAULT 

T" 

SWRITE 

WS 

"EXPROCFILE" 


SCLOSE WS 

SSET DEFAULT 'HOME' 


SEXIT 

SEXIT 

SWRITE 

SYSSOUTPUT "EASIE ID 

NOT ESTABLISHED" 


$E X I T 


B-2 



APPENDIX C 


EXECUTIVE LINK COMMAND FILE 


SLINK MASTER - 

+FASTAIDE - 
+RESPPROCS - 
+TEMPSUB - 
+1 NTERACT - 
+1 NTERPRET - 
+DISPLAY - 
+PERMENU - 
+GET - 
+GLOBS - 
+ERRORSUBS - 
+RIMSUB - 
+SYSUTIL - 
+TERMINAL - 
+EDTPL - 
+SLOG - 
+BATCH - 
+GETMENU - 
+AIDEUTIL - 

+USERLIB:TEK4100/LIBRARY - 
+USERLIB:CSCLIB/LIBRARY - 
+L0ADP10/LIBRARY 
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INSTALLATION TAPE BACKUP LISTING 

LISTING OF SAVE SET(S) 

SAVE SET: EASIE.BCK 

WRITTEN BY: CSC7 

UIC: [000100,000070] 

OATE: 27 -MAY-1987 14:25:56.71 

COMMAND: BACKUP /L I ST = [CSC 7 . TEAM 7 . SCOTT ]E AS I E . L I S/LOG/VER I F Y 

[CSC . EAS I ETAPE . . . ] TAPE : EAS I E . BC K/REW I ND/DENS I T Y = 1 600 
OPERATING SYSTEM: VAX/VMS VERSION V4.5 
BACKUP VERSION: V4.5 

CPU 10 REGISTER: 018432A5 

NODE NAME: SSD2 : : 

WRITTEN ON: DSAO: 

BLOCK SIZE: 13192 

GROUP SIZE: 10 

BUFFER COUNT: 3 

[CSC.EASIETAPE]AIDE.DIR;1 1 

[CSC.EASIETAPE.AIOE]BUILD OICT.OIR ;1 2 

[CSC. EAS I ETA PE .AIDE.BUILDDlCTjBUILD.DAT ; 1 6 

[CSC. EASIETAPE. AIDE. BUILD 0 I CT ]B U I LDD I CT . COM ; 1 1 

[CSC. EASIETAPE. AIDE . BU ILDD ICT ]BU I LD_EAS I E . COM ; 2 1 

[CSC. EASIETAPE. AIDE. BUILD DICT]BUILD EASIE.F0R;4 31 

[CSC .EASIETAPE .AIDE. BUI LDDlCTjBU I LDD AS IE .OBJ ;2 29 

[CSC. EASIETAPE. AIDE. BUILD D I CT ]COMPATl . COM ; 1 1 

[CSC. EASIETAPE. AIDE .BUILDUP ICTjFORMAT.FOR ; 1 7 0 

[CSC. EASIETAPE. AIDE. BUILD D I CT ]FORMAT . OB J ; 1 45 

[CSC. EASIETAPE. AIDE .BUILDUP ICT]F0RMRIM.F0R;1 71 

[CSC. EASIETAPE. AIDE. BU I LD_D ICT]FORMRIM.OBJ ; 1 59 

[CSC. EASIETAPE. AIDE. BUIL D_D ICT]GETDESC.FOR ; 1 5 

[CSC. EASIETAPE. AIDE. BUILD D I CT ]GE TDE SC . OB J ; 1 6 

[CSC.EASIETAPE.AIDE.BUILDnDICTjMAKDICT.COM ; 1 1 

[CSC. EASIETAPE. AIDE. BUILD D I CT ]MAKD I CT . FOR ; 1 83 

[CSC.EASIETAPE.AIDE.BUILDDlCTjMAKDICT.OBJ ;1 60 

[CSC. EASIETAPE. AIDE. BUIL D_D ICT jMAKDICTDB.COM ; 1 1 

[CSC. EASIETAPE. AIDE. BU I LDD ICTjMAKPRLSCH.FOR ;1 13 

[CSC. EASIETAPE. AIDE. BUILD D I CT jMAKPRL SCH . OB J ; 1 9 

[CSC. EASIETAPE. AIDE . BU I LDD ICTjMAKREV.FOR ; 1 11 

[CSC. EASIETAPE. AIDE. BUILD D I CT jMAKRE V . OB J ; 1 10 

[CSC. EAS I ETAPE. A IDE. BUI LDD ICT jMAKSC HEMA . FOR ;1 8 

[CSC. EASIETAPE. AIDE. BUILD D I CT jMAKSCHEMA . OB J ; 1 6 

[CSC. EASIETAPE. AIDE . BU I LDD ICT jMODDICT.FOR ; 1 9 

[CSC. EASIETAPE. AIDE. BU I LDD ICTjOPEN.FOR ; 1 6 

[CSC. EASIETAPE. AIDE. BUIL DD ICTjOPEN.OBJ ; 1 6 

[CSC. EASIETAPE. AIDE. BUILD D ICT jPROGRAM . FOR ; 1 7 

[CSC. EASIETAPE. A I DE . BU I LDD ICTjPROGRAM.OBJ ; 1 7 

[CSC. EASIETAPE. AIDE. BUILD D ICT jPUTDESC . FOR ; 1 4 

[CSC. EASIETAPE. AIDE. BUIL DD ICTjRDDICT.FOR ; 1 84 

[CSC. EASIETAPE. AIDE. BU I LD_D ICTjRODICT.OBJ ; 1 57 
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[CSC.EASIETAPE .AIDEjDB.DIR ; 1 1 
[CSC.EASIETAPE.AIDE.08jAPEX.DAT; 1 5 
[CSC.EASIETAPE.AIDE.DBjCMDS.DAT; 1 2 
[CSC.EASIETAPE. AIDE. D8]DATA. DA T;1 5 
[CSC.EASIETAPE .AIDE. DB]DEFAULT.WS ; 2 2 
[CSC.EASIETAPE.AIDE.DBjHELP.DAT ; 1 2 
[CSC.EASIETAPE. A IDE. DB ]MAI N. DAT ; 2 2 
[CSC.EASIETAPE. AIDE. DB]MASTER WS.DAT;3 1 
[CSC.EASIETAPE.AIDE.DB]PBLD. D7rr ; 1 4 
[CSC.EASIETAPE. AIDE. DB]PREX. DA T;1 7 
[CSC.EASIETAPE. AIDE. D8]TBLD.DAT;1 3 
[CSC.EASIETAPE. AIDE. OB]WSC. DAT ;1 7 
[CSC.EASIETAPE.AIDE]DBSAV.DIR;1 1 
[CSC.EASIETAPE. AIDE. D8SAV]AIDMP. DAT ;1 27 
[CSC.EASIETAPE.AIDE.DBSAVjIDEASDMP.DAT; 1 8 
[CSC.EASIETAPE. AIDE ]EXAMPLE . DIR; 1 1 
[C SC. E AS IE TAPE. AIDE. EXAMPLE ]CFG. DIR ; 1 1 
[CSC.EASIETAPE. AIDE. EX AM PLE.CFG]DEFAULT.CFGD;1 1 
[CSC .EAS I ETAPE. AIDE. EXAMPLE .CFG ]DE FAULT. DIR ; 1 1 
[CSC.EASIETAPE. AIDE. EX AMPLE. CFG. DEFAULT]DATADB1. DA T;1 24 
[CSC.EASIETAPE. AIDE. EXAMPLE. CFG. DEFAULT]DATADB2. DAT ;1 8 
[CSC.EASIETAPE. AIDE. EX AMPLE. CFG. OEFAULT]DATADB3.DAT;l 1 
[CSC. EAS I ETAPE. A IDE. EXAMPLE. CFG jEXAMPLE. WS ;1 2 
[CSC.EASIETAPE. AIDE. EX AM PLE]DICTNRY.DIR;1 1 
[CSC. EAS I ETAPE. A IDE. EXAMPLE. DICTNRYjDICTl.DAT; 1 24 
[CSC.EASIETAPE.AIDE.EXAMPLE.DICTNRY3DICT2.DAT; 1 8 
[CSC .EASIETAPE.AIDE.EXAMPLE.DICTNRYjDICT3.DAT ; 1 1 
[CSC.EASIETAPE. AIDE. EX AM PLE]PROG. DIR; 1 1 
[CSC. EAS I ETAPE. A IDE. EXAMPLE. PROG ]BOX.APPLD ; 1 1 
[CSC.EASIETAPE. AIDE. EXAMPLE. PROG]BOXIN. REV ;1 2 
[C SC. E AS I ETAPE. A IDE. EXAMPLE. PROG ]BOX IN. TP LD; 1 0 
[CSC.EASIETAPE. AIDE. EX AM PLE.PROG]BOXOUT.REV;l 1 
[CSC. EAS I ETAPE. A IDE. EXAMPLE. PROG ]BOXOUT . TPLD ; 1 0 
[CSC.EASIETAPE. AIDE. EX AM PLE.PROG]DR AW IN. REV ;1 3 
[CSC. EAS I ETAPE. A IDE. EXAMPLE. PROG ]DRAW IN. TPLD ;1 0 
[CSC.EASIETAPE. AIDE. EX AM PLE.PROG]DRAWIT.APPLD;l 1 
[CSC.EASIETAPE. AIDE. EX AMPLE. PROG ]MAKGEO.APPLD;l 1 
[CSC. EAS I ETAPE. A IDE. EXAMPLE. PROG jMAKGEO I N.REV;1 2 
[CSC. EAS I ETAPE. A IDE. EXAMPLE. PROG jMAKGEO IN. TPLD ;1 0 
[CSC. EAS I ETAPE. A IDE. EXAMPLE. PROG jPROGR AM. PGD;1 2 
[CSC.EASIETAPE. AIDE. EXAMPLEjSOURCE.DIRjl 2 
[CSC.EASIETAPE. AIDE. EXAMPLE. SOURCE]BOX.COM;l i 
[CSC.EASIETAPE. AIDE. EXAMPLE. SOURCE]BOX.FOR;l 1 
[C SC. E AS I ETAPE. A IDE. EXAMPLE. SOURCE ]BOX. OBJ ;7 1 
[CSC. EAS I ETAPE. A IDE. EXAMPLE. SOURCE ]BOX IN. COMMON ;1 1 
[C SC. E AS I ETAPE. A IDE. EXAMPLE. SOURCE ]BOX IN. FOR ; 1 6 
[CSC.EASIETAPE. AIDE. EXAMPLE. SOURCE]BOXIN.OBJ;7 3 
[CSC.EASIETAPE. AIDE. EX AM PLE.SOURCE]BOXOUT .COMMON ; 1 1 
[CSC. EAS I ETAPE. A IDE. EXAMPLE. SOURCE jBOXOUT. FOR ;1 4 
[CSC. EAS I ETAPE. AIDE. EXAMPLE. SOURCE ]BOXOUT. OBJ; 7 3 
[CSC.EASIETAPE.AIDE.EXAMPLE.SOURCEjDRAW.COM ;1 1 
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[C SC. EAS IE TAPE .AIDE. EXAMPLE. SOURCE ]DRAW.FOR ; 1 6 
[CSC.EASIETAPE.AIDE.EXAMPLE.SOURCE]DRAW.OBJ;7 7 
[CSC. E AS IE TAPE. A IDE. EXAMPLE. SOURCE ]DR AW IN. ASS I GN ; 1 2 
[CSC.EASIETAPE.AIDE.EXAMPLE.SOURCE]DRAWIN.COM;l 1 
[CSC .EAS IE TAPE. A IDE. EXAMPLE. SOURCE ]DR AW IN. FOR ;1 11 
[CSC. EASIETAPE. AIDE. EX AM PLE.S0URCE]DRAWIN.0BJ;6 8 
[CSC .EAS IETAPE .A IDE. EXAMPLE. SOURCE ]MAKGEO.COM ; 1 1 
[C SC. EAS I ETAPE. A IDE. EXAMPLE. SOURCE ]MAKGEO. FOR ; 1 3 
[CSC. EASIETAPE. AIDE. EXAMPLE. SOURCE ]MAKGE0.0BJ;6 2 
[CSC. EAS I ETAPE. A IDE. EXAMPLE. SOURCE ]MAKGEO IN. COMMON ;1 1 
[C SC. EAS I ETAPE. A IDE. EXAMPLE. SOURCE ]MAKGEO IN. FOR ;1 6 
[CSC. EAS IETAPE. A I DE . E XAMPLE . SOURCE ]MAKGEO I N.0BJ;6 3 

[CSC. EAS I ETA PE. A IDE. EXAMPLE. SOURCE JMAKGEOOT. COMMON ;1 1 
[CSC .EASIETAPE .AIDE .EX AMPLE. SOURCE ]MAKGEOOT. FOR ; 1 9 
[C SC. EAS I ETAPE. A IDE .EXAMPLE. SOURCE ]MAKGEOOT. OBJ ;6 4 
[CSC. EASIETAPE. AIDElEXMENU.DIR;l 1 
[CSC. EASIETAPE. AIDE. EXMENU ]CFG.DIR;1 1 
[CSC. EASIETAPE. AIDE. EXMENU.CFG]EXMENU.PROC;l 1 
[CSC. EASIETAPE. AIDE. EXMENU. CFG]EXMENU.PROCD;l 1 
[CSC. EASIETAPE. AIDE. EXMENU. CF G ]E XME NU . PROC 1 ; 1 1 
[CSC. EAS I ETAPE. A IDE. EXMENU. CFG ]E XMENU . PR0C~2 ; 1 1 
[CSC. EASIETAPE. AIDE. EXMENU. CFGjEXMENU. PROC~3 ; 1 1 
[CSC. EASIETAPE. AIDE. EXMENU. CFG]EXMENU.WS; 1 2 
[CSC. EASIETAPE. AIDE. EXMENU. CFGlEXMENU.WSD;l 1 
[CSC. EASIETAPE. AIDE]EXSIMPLE. DIR ; 1 1 
[CSC. EASIETAPE. AIDE. EXSIMPLE]BOX.COM;l 1 
[CSC. EASIETAPE. AIDE. EXSIMPLE]BOX. FOR ; 1 1 
[CSC. EASIETAPE. AIDE. EXSIMPLE]BOX.OBJ;l 1 
[CSC .EAS I ETAPE. A IDE. EXSIMPLE ]BO X I N . COMMON ; 1 1 
[CSC. EASIETAPE. AIDE. EXSIMPLE]BOXIN.FOR;l 6 
[CSC. EASIETAPE. AIDE. EXSIMPLEjBOXIN. OBJ ; 1 3 
[CSC. EAS IETAPE. AIDE. E XS IMPLE ]BO X I N . REV ;1 2 
[CSC. EASIETAPE .AIDE. EXSIMPLE ]BOXOUT. COMMON ; 1 1 
[CSC. EASIETAPE. AIDE. EXSIMPLE]BOXOUT.FOR;l 4 
[CSC. EASIETAPE. AIDE. EXSIMPLE]BOXOUT.OBJ;l 3 
[CSC. EASIETAPE. AIDE. EXSIMPLE]BOXOUT. REV ;1 1 
[CSC. EAS I ETAPE. A IDE. EXSIMPLE DDATADB1.DAT; 1 24 
[CSC. EASIETAPE. AIDE. EXSIMPLE]DATADB2.DAT;1 8 
[CSC. EASIETAPE. AIDE. EXSIMPLE]DA TADB3.DAT ; 1 1 
[CSC. EASIETAPE. AIDE. EXSIM PL E]DICT1. DAT ;1 24 
[CSC. EASIETAPE. AIDE. EXSIMPLE]DICT2. DAT ;1 8 
[CSC. EASIETAPE. AIDE. EXSIMPLE]DICT3. DAT ;1 1 
[CSC. EASIETAPE. AIDE. EXSIMPLE ]SCHEMA. DAT ;1 1 
[CSC. EASIETAPE. AIDE]HELP. DIR ;1 1 
[CSC. EASIETAPE. AIDE . HELP ]ACT . DAT ; 1 7 
[CSC. EASIETAPE. AIDE. HELP]CMDS. DAT ;1 2 
[C SC. E AS I ETAPE. A I DE. HELP ]ED IT. DAT; 1 4 
[CSC. EAS I ETAPE. A IDE. HELP ]ERRS. DAT ;1 8 
[CSC.EASIETAPE.AIDE.HELP]HELPFILES.DAT;1 27 
[C SC. EAS I ETAPE. A IDE. HELP ]IND. DAT ;1 1 
[CSC.EASIETAPE.AIDE.HELPDINDX.DAT; 1 2 
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[CSC.EASIETAPE.AIDE.HELPlOBJ.DAT; 1 
[CSC. EASIETAPE. AIDE. HELP]PERM.DAT;1 
[CSC.EASIETAPE.AIDElLOGIN.COM; 1 
[CSC. EASIETAPE. A I DEjPROC. DIR ;1 
[CSC. EASIETAPE. A IDE. PR0C1AIDE.COM; 2 
[CSC.EASIETAPE.AIDE.PR0C1AIDEINIT.COM ;8 
[CSC. EASIETAPE. A I DE.PR0C1ATTDIR.COM; 5 
[C SC. E AS I ETA PE. A IDE. PROClCOPYCFG.COM ; 5 
[CSC. EASIETAPE. A I DE.PR0C1DELDB.COM; 8 
[CSC. EASIETAPE. A I DE.PR0C1LSTDIR.COM; 3 
[CSC. EASIETAPE. A I DE.PROClOPNBATCH.COM; 5 
[CSC. EASIETAPE. AIDE. PR0C1 UNA IDEINIT.C0M;16 
[CSC. EASIETAPE. A I DE1PR0G. DIR ;1 
[C SC. EASIETAPE. AIDE. PROG 1AIDEUTIL.F OR ;33 
[CSC. EASIETAPE. AIDE. PROG ]AIDEUTIL.08J;6 
[CSC . EASIETAPE. A IDE. PROG ]A IDE UTIL. OLB ;6 
[CSC. EASIETAPE. A IDE. PROG ]BATCH. FOR ; 32 
[CSC.E AS IE TAPE .AIDE. PROG ]BATCH. OBJ ;2 
[CSC. EASIETAPE. AIDE. PR 0G]CRELNM.F0R;42 
[CSC. EASIETAPE. A IDE. PROG 1DC0MPILE.COM; 3 
[C SC. EASIETAPE. AIDE. PROG 1DISPLAY. FOR; 25 
[CSC. EASIETAPE. AIDE. PR0G]DISPLAY.0BJ;4 
[CSC. EASIETAPE. A IDE. PR OG]DLOAD.COM; 36 
[C SC. EASIETAPE. A IDE. PROG 1EDTPL.F OR ; 8 
[C SC. EASIETAPE. AIDE. PROG 1EDTPL. OBJ; 3 
[CSC. EASIETAPE. AIDE. PROG ]ERRORSUBS.F OR ;6 
[C SC. EASIETAPE. AIDE. PROG 1ERR0RSUBS. OBJ; 2 
[CSC. EASIETAPE. AIDE. PROG ]FASTA IDE. F OR ;52 
[CSC. EASIETAPE. AIDE. PROG]FASTAIDE. OBJ ;7 
[CSC. EASIETAPE. AIDE. PROG ]GET. FOR ;25 
[CSC. EASIETAPE. AIDE. PR0G]GET.0BJ;7 
[CSC. EASIETAPE. A IDE. PROG ]GETMENU . FOR ; 20 
[CSC. EASIETAPE. AIDE. PR0G]GETMENU.0BJ;7 
[CSC. EASIETAPE. AIDE. PROG 1GL OB A L S . I N C ; 1 
[CSC. EASIETAPE. AIDE. PROGlGLOBS. FOR ;8 
[C SC.E AS IE TAPE. AIDE. PROG 1GL0BS.0B J ;4 
[CSC. EASIETAPE. A I DE . PROG ] I NTE R ACT . FOR ; 10 
[C SC. EASIETAPE. AIDE. PROG 1INTER ACT. OBJ; 3 
[C SC.E AS IE TAPE. A IDE. PROG 1 INTERPRET. FOR ; 9 
[CSC. EASIETAPE. AIDE. PROG 1INTERPRET. OB J;3 
[CSC. EASIETAPE. A I DE.PR0G1L0AD.C0M; 5 
[CSC. EASIETAPE. AIDE. PR0G1L0CALS. INC ;1 
[CSC. EASIETAPE. AIDE. PR 0G]L0CALS2. INC ; 1 
[CSC. EASIETAPE. AIDE. PROG ]M ASTER. F0R;11 
[CSC. EASIETAPE. AIDE. PROG 1M ASTER. OBJ ;2 
[CSC. EASIETAPE. A IDE. PROG 1PERMENU. FOR ; 31 
[CSC. EASIETAPE. AIDE. PROG]PERMENU. OBJ; 6 
[CSC. EASIETAPE. A IDE. PROG 1PTH2F I L. FOR ; 27 
[CSC.E AS I ETA PE. A I DE.PR0G1PUTTRM.C0M; 9 
[CSC. EASIETAPE. AIDE. PROG ]PUTTRM.F0R;6 
[CSC. EASIETAPE. AIDE. PR0G]RESPPR0CS.F0R;81 
[CSC. EASIETAPE. AIDE. PROG 1RESPPR0CS.0BJ;29 


6 

3 
1 
1 
1 

5 
1 
1 
1 
1 
1 
1 

4 

22 

20 

72 

14 
21 

6 
1 

15 
20 

1 

32 

33 
11 

17 
30 
69 
22 
26 
12 

18 
3 

11 

12 

10 

24 

36 

44 

1 

2 

3 

3 

3 

27 

41 

8 

1 

3 

134 

157 
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[CSC. EASIETAPE. AIDE. PR0G]RIMSUB.F0R;45 36 
[C SC.E AS IE TAPE. AIDE. PROG ]RIMSU8. OBJ ;4 43 
[CSC. EASIETAPE. AIDE. PROG]SLOG. FOR ; 13 50 
[CSC. EASIETAPE. AIDE. PR0G]SL0G.0BJ;4 50 
[C SC. E AS I E TAPE. A IDE. PROG IS YSUT I L. FOR; 55 23 
[CSC. EASIETAPE. AIDE. PROG ]S YSUTIL. OB J;6 25 
[CSC. EASIETAPE. AIDE. PR0G]SYSUTIL.0LB;5 77 
[CSC. EASIETAPE. AIDE. PROG 3TEM PSUB . FOR ; 4 5 53 
[C SC. EASIETAPE. AIDE. PROG ]TEMPSUB. 08 J ; 5 84 
[CSC. EASIETAPE. A IDE. PROG TERMINAL. FOR; 22 13 
[C SC. EASIETAPE. A IDE. PROG ]TERMI NAL.OBJ ; 2 17 
[CSC. EASIETAPE. A IDE. PROG ]TERM I NAL.OLB ;2 68 
[CSC. EASIETAPE. A I DE]REVIEW. DIR ; 1 1 
[CSC. EASIETAPE. A IDE. REV I EW]R4. FOR ;1 196 
[CSC. EASIETAPE. AIDE. REVIEW]R4. OBJ ; 1 123 
[CSC.EASIETAPE.AIDE.REVIEW]R IMLOD.COM; 2 1 
[CSC. EASIETAPE ]BUIL0.C0M;3 9 
[CSC.EASIETAPE]CSCLIB.F0R;1 24 
[CSC.EASIETAPE]CSCLIB.0LB;1 66 
[CSC.EASIETAPE]TEK4100.F0R;1 72 
[CSC.EASIETAPE]TEK4100.0LB;1 144 

TOTAL OF 223 FILES, 3366 BLOCKS 
END OF SAVE SET. 
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$ j ***** 
$ j ***** 
j j ***** 
j j ***** 
$ j ***** 

$ j ***** 
j i * * * * ★ 

$ j ***** 
$ ! ***** 
$ i ***** 
j i ***** 

$ j ★** ** 
ji***** 
j i ***** 
j j ***** 
^ I ***** 
$ j ***** 

$ j ***** 
$ i ***** 
j i ***** 
^ i ***** 
^ i ***** 
j i ***** 
j i ***** 
j i ***** 
j i ***** 
j i ***** 
$ ; ***** 
$ j ***** 

$ j ***** 
^ i ***** 
j i ***** 
j i ***** 

$ j ***** 
$ i ***** 

$ I ***** 
^ i ***** 

$ j ***** 
$ j ***** 
j i ***** 
$ i ***** 
j i ***** 
$ i ***** 
$ ! ***** 
$; ***** 
$ j ***** 
$ j ***** 
$ I ***** 
$ j ***** 


BUILD EASIE EXECUTABLES COMMAND FILE 




BUILD.COM IS A VMS 4.4 COMMAND ***** 
FILE USED TO LINK THE REQUIRED ***** 
EASIE EXECUTABLES. ***** 

***** 

IT IS ASSUMED THAT EASIE ***** 
MODULES WERE TRANSFERRED FROM ***** 
MAGNETIC TAPE USING THE VMS ***** 
BACKUP UTILITY (THUS PRESERVING ***** 
THE NECESSARY DIRECTORY STRUCTURE)***** 
***** 

THE TOP LEVEL DIRECTORY HAS A ***** 
RELATIVE PATHNAME OF: ***** 
[.CSC] ***** 
IT IS NECESSARY TO "RUN" THE ***** 
THE COMMAND FILE, BUILD.COM, ***** 
WHILE "ATTACHED" TO THIS AREA BY ***** 
ENTERING: ***** 
BUILD ***** 
***** 

THE REQUIRED COMMAND, OBJECT, AND ***** 
LIBRARY FILES ARE INCLUDED MAKING ***** 
COMPILATION UNNECESSARY IN MANY ***** 
INSTANCES. (IF COMPILATION IS ***** 
REQUIRED, CHECK THE SPECIFIED ***** 
SUBDIRECTORY FOR A ".COM" FILE ***** 
WITH APPROPRIATE COMPILER ***** 
PARAMETERS.) ***** 

***** 


THE INITIAL PORTION OF THE COMMAND***** 
FILE IS USED FOR DEFINING SYMBOLS.***** 
THE EASIE IMPLEMENTER MUST RESET ***** 
THESE SYMBOLS ACCORDING TO HIS/HER***** 
SYSTEM. THE SYMBOLS LOADRIM AND ***** 
L0ADP10 ARE USED TO LOAD THE RIM ***** 
AND PLOT- 1 0 PROPRIETARY LIBRARIES ***** 
DURING THE LINKING PROCESS. THE ***** 


SYMBOL USERLIB IDENTIFIES THE ***** 
LOCATION OF THE TWO USER OBJECT ***** 
LIBRARIES, TEK4100 AND CSCLIB. ***** 
(THESE TWO USER LIBRARIES MAY BE ***** 
PLACED ANYWHERE BY THE IMPLEMENTER***** 
AS LONG AS SYMBOL USERLIB REFLECTS***** 
THE PROPER LOCATION.) ***** 
***** 

THE OTHER SYMBOLS ARE USED DURING ***** 
EASIE EXECUTION (IN ADDITION TO ***** 
THE LINKING PROCESS). FOR THIS ***** 
REASON THESE SYMBOLS SHOULD BE ***** 


E-l 


APPENDIX E 


ENTERED INTO A PROSPECTIVES USER'S***** 
LOGIN.COM FILE. THE SYMBOLS IN ***** 
THIS CATEGORY INCLUDE: ***** 

TOAIDE, RUNRIM, RUNDICT, REVIEW, ***** 
AND AIOEX. ***** 

IN THE CASE OF RUNRIM, THE SYMBOL ***** 
SHOULD INCLUDE THE AREA CONTAINING***** 
THE RIM EXECUTABLES. ***** 

THE SYMBOL AIDEX, POINTS TO A ***** 
COMMAND FILE WHICH MAY BE USED TO ***** 
INITIATE EASIE EXECUTION. ***** 

************************************************** 


* * *** 
★ * *★* 
***** 
★ * * * * 
***** 
***** 
★ * * ★ ★ 
***** 
***** 
***** 
* * * * * 


s 
$ 
s 
$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ ! DEFINE VMS SYMBOLS 

$DEF I NE TOAIDE DUB 1 : [CSC . E AS I ETAPE . A I DE . ] 

$DEF I NE L0ADP10 "DUA2 : [L I BS ]PLOT 1 0 " 

SDEFINE LOADRIM "S YS $S YSDE V I CE : [R I M . R IM 6 ]R I ML I B " 
SDEFINE USERLIB DUB 1 : [CSC . E AS I ETAPE ] 

SRUNRIM :== R S YSSSYSDEVICE : [R I M . R IM 6 ]R I M 
SRUNDICT :== R TOA I DE : [BU I LD DICT]MAKDICT 
SREVIEW :== STOAIDE: [REVIEW]TT4 
$ A I D E X :== OTOAIDE: [PROC ]A I DE . COM 
$ ! 

$! BUILD THE EASIE EXECUTIVE 

$SET DEF [.AIDE. PROG] 

S0LOAD 

S0PUTTRM 

SPURGE 

$ ! BUILD REVIEWER 

SSET DEF [-.REVIEW] 

$0R I MLOD 
SPURGE 

S! BUILD THE DATA DICTIONARY TEMPLATE UTILITIES 

SSET DEF [-.BUILD DICT] 

S0MAKDICT ~ 

SOBUILD EASIE 
SPURGE 

S! BUILD THE APPLICATION PROGRAMS 

S! TO DOCUMENTED EXAMPLES 

SSET DEF [-.EXSIMPLE] 

S0BOX 
SPURGE 
SSET DEF 
SPBOX 
S0DRAW 
SPMAKGEO 
S0DRAWIN 
SSET DEF 
SPURGE 
SSET DEF 


CORRESPONDING 


[-.EXAMPLE. SOURCE] 

[-.PROG] 

[---] 
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